QUEUE-DELETE Request
Function
The QUEUE-DELETE request is used to delete messages from the RRI message queue.
Features
You can only delete the oldest message of a message type. You must always state "Msgld".
Request Parameters
A request is composed of the fields described below:
| K/V Keyword | XML Namespace and Element | Occurrence min - max | Type / Length | Value Range | Description |
|---|---|---|---|---|---|
| Action | queue-delete | 1 | enumeration | queuerdelete-erule | This is the request type. |
| Version | - | 1 | enumeration | version-erule | This is the version. The keyword is only relevant for requests in the key/value format. |
| CtId | ctid | 0 - 1 |
token 3 - 64 |
Any visible Unicode character (according to Unicode version 3.1) | This is the unique transaction ID which is issued by the client. |
| MsgId | msgid | 1 |
token 30-255 |
msgid-rule | This is the unique message ID. |
| MsgType | msgtype | 0-1 | enumeration | msgtype-erule | This is the message type; if the keyword "MsgType" contains an empty value, the oldest message (sorted according to MsgTime) will be deleted. |
Common Mistakes
A QUEUE-DELETE request with an "Msgld" is tried to be submitted; but according to "MsgTime" the message referenced by the ID is not the oldest one ("MsgTime" is output as part of the response to a QUEUE-READ request).